home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / lib / mntolb44.zoo / README.bin < prev   
Encoding:
Text File  |  1993-06-17  |  3.4 KB  |  80 lines
  1. This archive contains the compiled MiNT libraries for GCC.
  2.  
  3. To use these libraries, you need the corresponding set of include
  4. files.
  5.  
  6. This archive does not contain the curses or PML libraries.  I may
  7. include them in the future if and when I get my act together.
  8.  
  9. Starting with patchlevel 32, I am distributing the library binaries
  10. with the "alternate" names (e.g. mint.olb instead of gnu.olb, and so
  11. on).  So you must either use the "-mint" flag when linking, or rename
  12. the files to the "standard" names gcc is looking for.  I'm doing this
  13. because I am keeping binaries for both the MiNT libs and TOS libs on
  14. the cross-compiler here, and it makes my life easier.  Feel free to
  15. let me know if you don't like this, and maybe I'll write a script to
  16. produce the archive with the normal names.
  17.  
  18. Bug reports go to:  entropy@terminator.rs.itd.umich.edu
  19.  
  20. Cheers,
  21. entropy
  22.  
  23. Eric's original readme follows:
  24.  
  25. ========================================================================
  26.  
  27. To use the MiNT library enclosed herein, you will need the MiNT
  28. include files (see mntinc25.zoo). The MiNT include files should
  29. be compatible with the "standard" gcc include files, but provide
  30. some definitions that are true only if __MINT__ is defined. As
  31. shipped, __MINT__ is always defined. If you would prefer to compile
  32. with the "normal" gcc libraries most of the time, then the following
  33. steps are necessary:
  34.  
  35. (1) Copy all the files in mntinc25.zoo into your include
  36.     directory, overwriting the old include files where
  37.     applicable.
  38. (2) Comment out the definition of __MINT__ in the include file
  39.     compiler.h.
  40. (3) Rename the gnu.olb and gnu16.olb from this library to mint.olb
  41.     and mint16.olb, respectively; and rename crt0.o and gcrt0.o to
  42.     mcrt0.o and mgcrt0.o respectively.
  43. (4) Use gcc's -mint flag to link with the MiNT library.
  44.  
  45.  
  46. Personally, I use the MiNT libraries for everything (replacing the gcc
  47. libraries entirely) since 99% of the functions also work under TOS,
  48. and the 1% that don't are things like fork() and pipe() that one
  49. wouldn't really expect to work in a single-tasking OS. However,
  50. everyone seems to have their own preferences on this matter.
  51.  
  52. A couple of other points: the files that have names starting with 'b'
  53. are compiled with the -mbaserel flag which is supported by Howard Chu's
  54. version of gcc 2.2.2.
  55.  
  56. Also: you may notice that there's no termcap.olb or termcap16.olb. That's
  57. to save space; the files in the termcap library are already in the curses
  58. library, so you can simply copy (or better yet, make a symbolic link from)
  59. curses.olb to termcap.olb, bcurses.olb to btermcap.olb, etc.
  60.  
  61. There are no docs; I recommend getting the source code (see mntlib25.zoo)
  62. and using that. The documentation for the gcc library applies to a
  63. lot of this library, too, so you could get that; and a good book on
  64. Unix and ANSI C programming would help a lot, since the library is mostly
  65. ANSI and Posix compatible.
  66.  
  67. The library is based on the gcc library that Jwahar Bammi and I put together.
  68. Lots of people have contributed to it, including (but not limited to):
  69.  
  70. Adrian Ashley, Jwahar Bammi, Scott Bigham, Kai-Uwe Bloem, Howard Chu,
  71. John R. Dunning, Doug Gwyn, Dave Gymer, Michael Hohmuth, Alan Hourihane,
  72. Alex Kiernan, Ulf Moeller, Allan Pratt, Arnold D. Robbins, Edgar Roeder,
  73. Rich Salz, Dale Schumacher, Andreas Schwab, Eric Smith, Henry Spencer,
  74. and Stephen Usher.
  75.  
  76. I've hacked on things quite a bit, so if they're broken don't blame the
  77. original authors, blame me.
  78.  
  79. Eric R. Smith
  80.